Skip to content

docs(website): add animated architecture diagrams#21

Merged
enixCode merged 1 commit into
mainfrom
docs/architecture-diagrams
Jun 2, 2026
Merged

docs(website): add animated architecture diagrams#21
enixCode merged 1 commit into
mainfrom
docs/architecture-diagrams

Conversation

@enixCode
Copy link
Copy Markdown
Owner

@enixCode enixCode commented Jun 2, 2026

What

Three custom animated SVG/React figures for the docs, in the light-* design (icy-blue on near-black, Fraunces + JetBrains Mono), framed as diagram panels so they read the same in light and dark Fumadocs themes.

  • Architecture - the 3-tier delegation chain (light-process -> light-run -> light-runner -> Docker), request token down / result token up. In Overview + Execution.
  • Dag - the flagship workflow graph: fan-out + a conditional when link. In Workflows.
  • NetworkServices - the proxy/secret pattern: the key stays in the proxy, the workload reaches it by hostname. In the Services section.

Why

The docs explained the model in prose; these give the three core concepts a visual anchor. Same stack as the other light-* sites, additive only.

Notes

  • Pure CSS animation, no client JS, so they survive the Next static export and honour prefers-reduced-motion.
  • Tokens are hardcoded in diagrams.module.css (the landing CSS variables are not in scope inside the docs).
  • npx tsc --noEmit passes; the Next build is the CI oracle (Google Fonts fetch fails offline).

build with cc

Custom SVG/React figures in the light-* design (icy-blue on near-black,
Fraunces + JetBrains Mono), framed as diagram panels so they read the same
in light and dark Fumadocs themes. Pure CSS animation, no client JS, so they
survive static export, and honour prefers-reduced-motion.

- Architecture: the 3-tier delegation chain (light-process -> light-run ->
  light-runner -> Docker) with a request token down and a result token up.
  Embedded in the Overview and Execution pages.
- Dag: the flagship workflow graph, fan-out plus a conditional link. Embedded
  in Workflows.
- NetworkServices: the proxy/secret pattern, the key stays in the proxy and
  the workload reaches it by hostname. Embedded in the Services section.

build with cc
@enixCode enixCode merged commit 2172412 into main Jun 2, 2026
5 checks passed
@enixCode enixCode deleted the docs/architecture-diagrams branch June 2, 2026 21:56
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant